Release 10.1A: OpenEdge Development:
Web Services

Using a SOAP message viewer

To view SOAP messages as they are sent and received, use a SOAP message viewer. Table 7–3 lists some examples.

Table 7–3: Some SOAP message viewers

This SOAP message viewer...	Is...
WSAViewer	Provided with the OpenEdge installation.
ProSOAPView	Provided with the OpenEdge installation.
Microsoft SOAP Toolkit	Available for free download from Microsoft’s Web site.

To use a SOAP message viewer:

Change the Web service client to send requests to the port of the SOAP message viewer by changing the SOAP end point’s URL host and port fields.
Configure the SOAP message viewer to forward requests to the host and port of the WSA, where the Web service is deployed, and run the viewer.

To configure and run WSAViewer:

Enter the wsaviewer command from a Proenv shell using the following syntax:

Syntax

wsaviewer listen-port WSA-host WSA-port

Change the Web service URL in the Web service client to access the WSAViewer. Assume that the original Web service URL in the is as follows:

http://bedrockquarry.com:8080/wsa/wsa1

In the client, change this URL to use an agreed-upon viewer listening port:

http://bedrockquarry.com:8081/wsa/wsa1

To run the WSAViewer, enter this command in the Proenv shell on the WSA machine:

wsaviewer 8081 localhost 8080

The WSAViewer runs configured to listen for requests from the reconfigured client interface on port 8081 and forward those requests to port 8080. SOAP responses from the WSA, then, move in the reverse direction.

Figure 7–1 shows the main window of the WSAViewer when it first opens.

Figure 7–1: WSAViewer main window

SOAP requests from the client appear in the left-hand viewer and SOAP responses from the WSA forwarded back to the client appear in the right-hand viewer. A continuous stream of requests and responses is recorded that you can review by using the vertical scroll bars.

To configure and run ProSOAPView, see Chapter 12, " Handling Errors in Progress 4GL Requests to Web Services."

ProSOAPView is more general purpose than WSAViewer, and it allows you to trace not only SOAP messages, but also HTTP messages and other document contents exchanged between a client and server. ProSOAPView works as both an HTTP proxy server and an HTTP client that can connect to your choice of another proxy server or the final destination.